package com.tjetc.dao;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.tjetc.entity.TravelGuide;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 旅游攻略数据访问对象接口
 * 提供了对travel_guide表的基础和自定义的数据库操作方法
 * 继承自MyBatis-Plus的BaseMapper以获取通用的CRUD方法
 */
public interface TravelGuideMapper extends BaseMapper<TravelGuide> {

    /**
     * 根据攻略ID查询完整的攻略信息
     * 这个方法会返回包含所有字段的攻略对象，通过XML映射文件中的SQL实现
     *
     * @param id 攻略ID
     * @return 攻略对象，如果不存在则返回null
     */
    TravelGuide findGuideById(@Param("guide_id") Long id);

    /**
     * 获取热门攻略列表
     * 根据浏览量降序排序，获取指定数量的热门攻略
     *
     * @param limit 返回的最大记录数量，如果为null则返回所有结果
     * @return 热门攻略列表
     */
    List<TravelGuide> hotGuides(@Param("limit") Integer limit);

    /**
     * 根据目的地查询攻略
     * 支持模糊查询，会在目的地字段中查找包含指定字符串的记录
     *
     * @param destination 目的地名称（全部或部分名称）
     * @return 匹配目的地条件的攻略列表
     */
    List<TravelGuide> findByDestination(@Param("destination") String destination);

    /**
     * 查询指定作者的所有攻略
     * 按创建时间降序排序，展示最新的攻略在前
     *
     * @param authorId 作者ID
     * @return 该作者创建的所有攻略列表
     */
    List<TravelGuide> findByAuthor(@Param("author_id") Long authorId);

    /**
     * 获取被推荐的攻略列表
     * 返回is_featured字段为1的攻略，按创建时间降序排序
     *
     * @param limit 返回的最大记录数量，如果为null则返回所有推荐攻略
     * @return 推荐攻略列表
     */
    List<TravelGuide> findFeatured(@Param("limit") Integer limit);

    /**
     * 获取编辑推荐的攻略列表
     * 返回is_editor_choice字段为1的攻略，按创建时间降序排序
     *
     * @param limit 返回的最大记录数量，如果为null则返回所有编辑推荐攻略
     * @return 编辑推荐攻略列表
     */
    List<TravelGuide> findEditorChoice(@Param("limit") Integer limit);

    /**
     * 增加攻略的浏览次数
     * 将指定攻略的view_count字段值加1
     *
     * @param guideId 攻略ID
     */
    void incrementViewCount(@Param("guide_id") Long guideId);

    /**
     * 增加攻略的点赞次数
     * 将指定攻略的like_count字段值加1
     *
     * @param guideId 攻略ID
     */
    void incrementLikeCount(@Param("guide_id") Long guideId);

    /**
     * 增加攻略的收藏次数
     * 将指定攻略的favorite_count字段值加1
     *
     * @param guideId 攻略ID
     */
    void incrementFavoriteCount(@Param("guide_id") Long guideId);

    /**
     * 增加攻略的评论次数
     * 将指定攻略的comment_count字段值加1
     *
     * @param guideId 攻略ID
     */
    void incrementCommentCount(@Param("guide_id") Long guideId);

    /**
     * 增加攻略的编辑次数
     * 将指定攻略的edit_count字段值加1
     *
     * @param guideId 攻略ID
     */
    void incrementEditCount(@Param("guide_id") Long guideId);

    /**
     * 获取所有攻略
     * 不包含任何过滤条件，返回表中的所有记录
     *
     * @return 所有攻略列表
     */
    List<TravelGuide> selectAll();


    /**
     * 插入新的旅游攻略
     *
     * @param travelGuide 旅游攻略对象
     * @return 插入成功的记录数
     */
    int insert(TravelGuide travelGuide);
}